package com.wgh.product.service;

import com.wgh.product.entity.shop.ProductReview;
import com.wgh.common.vo.PageResult;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;
import java.util.Map;

/**
 * 商品评价服务接口
 * @author AI Shop
 */
public interface ProductReviewService extends IService<ProductReview> {

    /**
     * 分页查询商品评价
     * @param params 查询参数
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    PageResult<ProductReview> getReviewPage(Map<String, Object> params, Integer pageNum, Integer pageSize);

    /**
     * 根据商品ID查询评价列表
     * @param productId 商品ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    PageResult<ProductReview> getReviewsByProductId(Long productId, Integer pageNum, Integer pageSize);

    /**
     * 根据用户ID查询评价列表
     * @param userId 用户ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    PageResult<ProductReview> getReviewsByUserId(Long userId, Integer pageNum, Integer pageSize);

    /**
     * 根据评价ID获取评价详情
     * @param id 评价ID
     * @return 评价详情
     */
    ProductReview getReviewDetail(Long id);

    /**
     * 新增商品评价
     * @param productReview 评价信息
     * @return 是否成功
     */
    boolean addReview(ProductReview productReview);

    /**
     * 更新评价状态
     * @param id 评价ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateReviewStatus(Long id, Integer status);

    /**
     * 批量更新评价状态
     * @param ids 评价ID列表
     * @param status 状态
     * @return 是否成功
     */
    boolean batchUpdateReviewStatus(List<Long> ids, Integer status);

    /**
     * 回复评价
     * @param id 评价ID
     * @param replyContent 回复内容
     * @return 是否成功
     */
    boolean replyReview(Long id, String replyContent);

    /**
     * 根据商品ID统计评价信息
     * @param productId 商品ID
     * @return 统计信息
     */
    Map<String, Object> getReviewStatisticsByProductId(Long productId);

    /**
     * 获取有图评价列表
     * @param productId 商品ID
     * @param pageNum 页码
     * @param pageSize 每页数量
     * @return 分页结果
     */
    PageResult<ProductReview> getImageReviewsByProductId(Long productId, Integer pageNum, Integer pageSize);

    /**
     * 获取商品的平均评分
     * @param productId 商品ID
     * @return 平均评分
     */
    Double getAverageScoreByProductId(Long productId);
}